home *** CD-ROM | disk | FTP | other *** search
/ Windows 95 Super Collection / Windows 95 Super Collection.iso / win95 / programm / mdf150 / mdf_ita.txt < prev    next >
Encoding:
Text File  |  1995-11-12  |  17.8 KB  |  467 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                   MDIFF  -  MPATCH
  12.                                     Release  1.50
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.           Un software semplice ma completo per produrre e applicare patch a
  24.            programmi e file di dati per Dos, OS/2, Windows95 e WindowsNT.
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                              Manuale in lingua italiana.
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.                (C) 1995/96 Maurizio Giunti - Tutti i diritti riservati
  47.  
  48.  
  49.  
  50.  
  51.  
  52.      1.SOMMARIO
  53.  
  54.  
  55.      1.SOMMARIO                                                               2
  56.  
  57.  
  58.      2.GARANZIE                                                               3
  59.  
  60.  
  61.      3.USO E DISTRIBUZIONE                                                    3
  62.  
  63.  
  64.      4.PERCHE'                                                                3
  65.  
  66.  
  67.      5.A COSA SERVE                                                           3
  68.  
  69.  
  70.      6.ESEMPIO                                                                4
  71.  
  72.  
  73.      7.DOS, OS/2, WINDOWS 95 E WINDOWS NT                                     4
  74.  
  75.  
  76.      8.LIMITI E BUG NOTI                                                      4
  77.  
  78.  
  79.      9.MDIFF - MDIFF2 - MDIFFW                                                5
  80.  
  81.  
  82.      10.MPATCH - MPATCH2 - MPATCHW                                            5
  83.  
  84.  
  85.      11.MDF2EXE - MDF2EXE2 - MDF2EXEW                                         6
  86.  
  87.  
  88.      12.ALCUNI CONSIGLI                                                       6
  89.  
  90.  
  91.      13.LIBRERIE PER APPLICARE PATCH                                          7
  92.  
  93.  
  94.      14.COME REGISTRARSI                                                      7
  95.  
  96.  
  97.      15.COME CONTATTARE L'AUTORE                                              7
  98.  
  99.  
  100.      16.RINGRAZIAMENTI                                                        8
  101.  
  102.  
  103.  
  104.  
  105.  
  106.                                                                               2
  107.  
  108.  
  109.  
  110.  
  111.  
  112.      2.GARANZIE
  113.      QUESTO SOFTWARE E I FILE CHE LO ACCOMPAGNANO SONO DISTRIBUITI COSI' COME
  114.      SONO, E SENZA GARANZIE DI FUNZIONAMENTO O QUALUNQUE ALTRA GARANZIA.
  115.      L'unica  garanzia  fornita con  questo software  e  che occupa  spazio  su
  116.      disco.  Non posso assolutamente  garantire che   funzioni perfettamente  o
  117.      rappresenti la soluzione di ogni vostro problema. Sono inoltre  sicuro che
  118.      non  e un virus e   non contiene (a  meno che non sia  stato infettato   o
  119.      modificato  dopo  la  compilazione)  Trojan-Horses,  Back-Doors   o  altre
  120.      diavolerie  simili.  In ogni  caso  l'autore declina  ogni  responsabilita
  121.      diretta  o indiretta, per  eventuali danni   morali o materiali  derivanti
  122.      dal suo uso.
  123.  
  124.      3.USO E DISTRIBUZIONE
  125.      Questo software appartiene allo Shareware, cio significa che  chiunque puo
  126.      liberamente  distribuirlo e  puo usarlo  gratuitamente per  un periodo  di
  127.      prova  di 15 giorni.  Dopo tale  periodo gli utenti  che continueranno  ad
  128.      usarlo  devono registrare la loro  copia mandando il contributo  richiesto
  129.      all'autore, Maurizio Giunti.
  130.      Gli  utenti cosi registrati riceveranno  un _codice di registrazione_  che
  131.      conterra  il loro  nome (o  il nome  della loro  impresa in  caso di  site
  132.      license).
  133.      Questo  software  puo  essere liberamente  distribuito  ma  gratuitamente,
  134.      salvo le spese di copia e spedizione.
  135.      E'  imperativo che  il pacchetto  originale che contiene  il software  sia
  136.      distribuito senza alcuna modifica.
  137.      Gli   utenti  registrati  potranno  distribuire  liberamente   MPATCH.EXE,
  138.      MPATCH2.EXE  e MPATCHW.EXE insieme a uno o piu file *.MDF prodotti con  la
  139.      loro  copia registrata di  MDIFF. Inoltre gli  utenti registrati  potranno
  140.      liberamente  distribuire patch  auto installanti  create con  MDF2EXE.EXE,
  141.      MDF2EXE2.EXE  e MDF2EXEW.EXE,  che contengano solo  file *.MDF  realizzate
  142.      con una copia registrata di MDIFF.
  143.      In  ogni  caso i  file  di patch  *.MDF  create da  MDIFF  possono  essere
  144.      liberamente  distribuiti, l'autore di MDIFF  non reclama alcun diritto  su
  145.      di essi.
  146.  
  147.      4.PERCHE'
  148.      Qualche  tempo fa  dovevo rilasciare  una versione  aggiornata di  un  mio
  149.      programma:  il pacchetto compresso "pesava"  piu  di 200 Kbyte, e  sarebbe
  150.      stato  sicuramente  piu  conveniente  per  tutti  aggiornare   il  vecchio
  151.      eseguibile  tramite una patch.   Mi misi in caccia  di un software che  mi
  152.      permettesse  di creare e distribuire patch dei  miei programmi  per Dos  e
  153.      OS/2:  per Dos ne ho trovati alcuni (ma non mi hanno soddisfatto per  vari
  154.      motivi),   per  OS/2  neanche  uno!  Ho  quindi  deciso  di  farmene   uno
  155.      e....eccolo qui ! 8-)
  156.  
  157.      5.A COSA SERVE
  158.      MDIFF  crea un file binario  di differenza tra due  file. Con MPATCH e  il
  159.      vecchio  file  si  puo ricreare  il  nuovo  file   partendo  dal  file  di
  160.      differenza.  Cosa c'e di buono in tutto  cio? Semplice: supponendo che  il
  161.      file  di differenza  sia   piu breve  del nuovo  file, e  piu  conveniente
  162.      distribuire  solo  quello invece  di  tutto  il file,  soprattutto  se  la
  163.      distribuzione avviene via modem.
  164.  
  165.  
  166.                                                                               3
  167.  
  168.  
  169.  
  170.  
  171.      6.ESEMPIO
  172.      A  titolo  di  esempio ho  messo  in  due directory  chiamate  OLD  e  NEW
  173.      rispettivamente  MDIFF.EXE  release 1.45a  (una release  intermedia  sulla
  174.      quale stavo lavorando) e MDIFF.EXE release 1.45 definitiva:
  175.  
  176.      Directory of  OLD\*.EXE
  177.      MDIFF.EXE       46602  16/08/95   21.01
  178.  
  179.      Directory of  NEW\*.EXE
  180.      MDIFF.EXE       46602   21/08/95  00.45
  181.  
  182.      C:\>mdiff OLD\MDIFF.EXE NEW\MDIFF.EXE
  183.      MDIFF  V1.50 - MDF file generator (Dos)
  184.      (C) Copyright 1995/96 Maurizio Giunti
  185.  
  186.      Registered to: MAURIZIO GIUNTI
  187.  
  188.      OLD\MDIFF.EXE,NEW\MDIFF.EXE => MDIFF.MDF
  189.      Working...(100%)   MDF size: 1215 bytes   Rate: 2%
  190.      <Done!>
  191.  
  192.      Directory of  *.MDF
  193.      MDIFF.MDF        1215   7/10/95  13.43
  194.  
  195.      Adesso  possiamo applicare la  patch MDIFF.MDF al  vecchio eseguibile  per
  196.      ricostruire quello nuovo:
  197.  
  198.      C:\>mpatch MDIFF.MDF old\MDIFF.EXE
  199.      MPATCH  V1.50 - MDF file applier (Dos)
  200.      (C) Copyright 1995/96 Maurizio Giunti
  201.  
  202.      MDF file produced by: MAURIZIO GIUNTI
  203.  
  204.      Working: 0% |###########| 100%
  205.      <Done!>
  206.  
  207.      Ottenendo il seguente file:
  208.  
  209.      Directory of  *.EXE
  210.      MDIFF.EXE       46602  21/08/95   0.41
  211.  
  212.      che e identico al file MDIFF.EXE che della directory NEW.
  213.  
  214.      7.DOS, OS/2, WINDOWS 95 E WINDOWS NT
  215.      MDIFF  e  MPATCH  per  Dos,  OS/2  e  Windows  sono  ottenuti  tramite  la
  216.      compilazione  dei  medesimi sorgenti,  quindi  non c'e  alcuna  differenza
  217.      nella  funzione e nell'uso di tali  programmi sui vari sistemi  operativi.
  218.      Inoltre  i  files  *.MDF  prodotti  con MDIFF  per    Dos  possono  essere
  219.      utilizzati con MPATCH per OS/2 o Windows32 e viceversa.
  220.  
  221.      8.LIMITI E BUG NOTI
  222.      MDIFF  non puo trattare files piu ampi di 16 Megabyte o piu piccoli  di 20
  223.      volte la lunghezza del chunk settata.
  224.  
  225.  
  226.                                                                               4
  227.  
  228.  
  229.  
  230.  
  231.      Dato  che MDIFF per OS/2, e ottenuto tramite una compilazione diretta  dei
  232.      sorgenti  di MDIFF  per Dos,  non e  in grado  di trattare  gli  attributi
  233.      estesi, quindi si limitera ad ignorarli.
  234.      Inoltre  se si costruisce un file di patch con  MDIFF per Dos o OS/2 e  si
  235.      applica  con MPATCH per  Windows32 (o  viceversa) il file  che si  otterra
  236.      avra  la data  errata; cio  dipende da una  diversa implementazione  della
  237.      funzione utime() nei compilatori Borland e Microsoft.
  238.  
  239.      9.MDIFF - MDIFF2 - MDIFFW
  240.      Il programma MDIFF si occupa di comparare due files e di  immagazzinare le
  241.      differenze  tra di essi in un terzo  file  che, generalmente, e molto  piu
  242.      compatto. Vediamo come si usa:
  243.  
  244.         MDIFF [-C<c>] [-R<r>] [-F<f>] [-S] [-Z] [-P<pwd>] <OldFile> <NewFile>
  245.                                      [<MDFfile>]
  246.  
  247.      <OldFile>  ovviamente e  il nome  della versione  precedente del  file  da
  248.      comparare,  mentre  <NewFile>  e  il nome  della    versione  attuale.  Se
  249.      necessario  si puo specificare il  nome del file  di differenza da  creare
  250.      <MDFfile>,  altrimenti   MDIFF  crea un  file  che ha  lo stesso  nome  di
  251.      <NewFile>  ma estensione ".MDF".  Per cercare le  parti simili nei  files,
  252.      MDIFF  si serve di una stringa base di lunghezza predefinita detta  chunk.
  253.      La  lunghezza del chunk e per default di   16 byte ma puo essere  cambiata
  254.      (in  un range  4-256) con  lo switch  -C seguito  dalla lunghezza  voluta.
  255.      Quando   MDIFF perde il sincronismo tra i due files che sta  confrontando,
  256.      cerca di ritrovarlo scandendo il vecchio file alla  ricerca del  chunk che
  257.      sta  elaborando. Tale ricerca viene effettuata, in un intorno  dell'ultimo
  258.      chunk trovato, nel range definito dallo switch -R. Per default  tale range
  259.      e  di 8 blocchi di 512 byte, ma puo variare tra  1 e 16. Se tale   ricerca
  260.      fallisce  MDIFF cerca di forzare il sincronismo cercando in un raggio  piu
  261.      ampio di quello definito solitamente ampio 1/16 della lunghezza  del file.
  262.      Questa  seconda ricerca puo essere disabilitata o il suo range puo  essere
  263.      cambiato  tramite lo  switch -F.  Specificando lo  switch   -S, alla  fine
  264.      dell'operazione,  MDIFF  fornira alcuni  dati sulla composizione del  file
  265.      di differenza.
  266.      E'  inoltre  possibile,  tramite  lo  switch  -Z,  inserire  nel  file  di
  267.      differenza  un breve commento (al massimo 2 Kbyte), che sara  visualizzato
  268.      durante  l'applicazione della patch da parte di MPATCH. Il commento  viene
  269.      prelevato  direttamente  dallo  standard  input  e  quindi  puo  essere  o
  270.      digitato o prelevato da un file tramite l'apposito comando  di redirezione
  271.      "<".
  272.      Tramite lo switch -P si puo proteggere la patch con una  password (<pwd>):
  273.      chi non conosce tale password non potra applicare la patch.
  274.  
  275.      10.MPATCH - MPATCH2 - MPATCHW
  276.      MDIFF  sarebbe  un programma  inutile  se non  esistesse  MPATCH.  Infatti
  277.      MPATCH  si occupa,  dati <OldFile>  e  <MDFfile>,  di ricreare  <NewFile>.
  278.      Vediamo come si usa:
  279.  
  280.                  MPATCH [-P<pwd>] <MDFfile> [<OldFile> [<NewFile>]]
  281.  
  282.      L'unico  parametro necessario e il nome  del file di differenza  <MDFfile>
  283.      perche  esso  contiene i  nomi  degli altri  due   file,  ma  e  possibile
  284.      modificare  tale impostazione   semplicemente specificando  i nomi  voluti
  285.  
  286.                                                                               5
  287.  
  288.  
  289.  
  290.  
  291.      nell'esatto  ordine.  MPATCH  ha  il  solo  switch  -P  che   permette  di
  292.      specificare una eventuale password necessaria per applicare la patch.
  293.      In   caso  di  errore  MPATCH  ritorna  un  errorlevel  che  deve   essere
  294.      interpretato secondo la seguente tabella:
  295.      Codice      Descrizione
  296.      0           "OK!"
  297.      1           "Out of memory !"
  298.      2           "Can't open MDF file !"
  299.      3           "Invalid MDF file !"
  300.      4           "MDF file version mismatch !"
  301.      5           "UNREGISTERED !"
  302.      6           "Bad or incorrect OLD file !"
  303.      7           "Can't open OLD file !"
  304.      8           "Can't create NEW file !"
  305.      9           "General failure: NEW file corrupted !"
  306.      10          "OLD and NEW can't be the same file !"
  307.      11          "NEW file was already patched ! "
  308.      12          "Wrong password !"
  309.  
  310.      11.MDF2EXE - MDF2EXE2 - MDF2EXEW
  311.      MDF2EXE  si occupa di trasformare un file di patch *.MDF creato con  MDIFF
  312.      in  un file ESEGUIBILE autoinstallante per Dos (MDF2EXE), OS/2  (MDF2EXE2)
  313.      o Windows95/WindowsNT (MDF2EXEW).
  314.      Il file cosi creato conterra al suo interno il programma  di installazione
  315.      e un certo numero di file di patch (al massimo 127).
  316.      La sintassi per creare una patch autoinstallante e:
  317.  
  318.            MDF2EXE <mdf_file 1> [<mdf_file 2>....<mdf_file n>] <exe_file>
  319.  
  320.      I  vari <mdf_file  x> possono  contenere anche  wildcard, in  questo  caso
  321.      MDF2EXE crchera' automaticamente i files da inserire.
  322.      Il  file eseguibile creato (che DEVE  avere estensione .EXE) potra  essere
  323.      avviato   senza  alcun  parametro  sulla  linea  di  comando  e   cerchera
  324.      automaticamente i file da aggiornare. Opzionalmente puo  essere utilizzato
  325.      lo  switch -P per specificare una password  oppure gli switch -V o -L  per
  326.      visualizzare la lista delle patch contenute nel file.
  327.      Un'unica  nota: non comprimete le patch autoinstallanti con PKLite,  LZExe
  328.      o altri software simili, altrimenti esse cesseranno di funzionare.
  329.  
  330.      12.ALCUNI CONSIGLI
  331.      Il  metodo ottimale per costruire un file di differenza sarebbe quello  di
  332.      ricercare  per tutto il  vecchio file i  chunks  che  compongono il  nuovo
  333.      file;  ovviamente  tale  metodo  sarebbe  di  una   lentezza  esasperante.
  334.      L'algoritmo  su  cui  e  basato  MDIFF  rappresenta  un   compromesso  tra
  335.      risultato  e  velocita di  esecuzione,  per questo  e  talvolta  opportuno
  336.      regolare  i  parametri di  funzionamento  di MDIFF  tramite  gli  appositi
  337.      switch. Vediamo come comportarsi in  alcune situazioni tipiche:
  338.      1.        File  con pochissime modifiche: e'  opportuno utilizzare un chunk  molto
  339.        ampio (32, 64 o piu) in modo da  ridurre il piu possibile  le dimensioni
  340.        del  file di differenza, soprattutto  se si sta  lavorando con files  di
  341.        testo o con archivi.
  342.      2.        File di testo: di solito un chunk di dimensione 32 e il piu  indicato, e
  343.        opportuno  provare  a  diminuire o  togliere  il    sincronismo  forzato
  344.        tramite lo switch -F.
  345.  
  346.                                                                               6
  347.  
  348.  
  349.  
  350.  
  351.      3.        File  eseguibili molto  ampi: spesso   si  ottengono risultati  migliori
  352.        allargando il range di ricerca del  sincronismo  tramite lo switch -R.
  353.      Un  ultimo consiglio: non  attendetevi miracoli  da MDIFF. Se  i due  file
  354.      confrontati  sono molto dissimili il file di patch risultera molto  ampio.
  355.      In questi casi c'e ben poco da fare, bisogna rassegnarsi a  distribuire il
  356.      nuovo  file interamente. MDIFF e realmente utile  solo se il numero  delle
  357.      modifiche apportate ai file non e troppo grande.
  358.  
  359.      13.LIBRERIE PER APPLICARE PATCH
  360.      Nel  pacchetto di distribuzione di MDIFF troverete un set di librerie  per
  361.      il  linguaggio  C per  realizzare programmi  per applicare  patch.  Queste
  362.      librerie funzionano soltanto con file di patch *.MDF creati con  una copia
  363.      registrata  di MDIFF.  Cio non  significa che  queste librerie  non  siano
  364.      perfettamente funzionanti, significa soltanto che per  volonta dell'autore
  365.      le  librerie non possono applicare patch prodotte da copie non  registrate
  366.      di MDIFF.
  367.  
  368.      14.COME REGISTRARSI
  369.      Registrando  MDIFF otterrete un _codice di registrazione_ che contiene  il
  370.      vostro  nome (o il  nome della vostra  impresa in caso  di site  license).
  371.      Producendo  una patch con  una copia  registrata di MDIFF  nel file  *.MDF
  372.      risultante  verra incluso tale nome, in questo  modo al momento in cui  la
  373.      patch  verra applicata MPATCH potra mostrare il nome di chi ha  realizzato
  374.      la patch stessa.
  375.      Inoltre  gli utenti registrati sono autorizzati a distribuire  liberamente
  376.      MPATCH.EXE,  MPATCH2.EXE e MPATCHW.EXE  insieme alle patch  *.MDF da  essi
  377.      prodotte,  e a distribuire ogni patch  auto installante che contenga  solo
  378.      file *.MDF prodotti con la loro copia registrata di MDIFF.
  379.      Per  registrare MDIFF  dovrete utilizzare  il programma  REGISTER.EXE  che
  380.      troverete nel pacchetto di distribuzione. REGISTER.EXE e  una applicazione
  381.      per  Windows  scritta  da  Grzegorz (Greg)  Kochaniak  che  si  occupa  di
  382.      raccogliere   interattivamente  tutte  le   informazioni  necessarie   per
  383.      richiedere  la registrazione  di MDIFF,  e a prepararle  per spedirle  via
  384.      Posta,  TeleFAX o e-mail alla Kagi Shareware. Se non siete utenti  Windows
  385.      contattatemi.
  386.      Per  qualunque informazioni  sui servizi  di Kagi  Shareware vi  invito  a
  387.      leggere il file KAGI.TXT.
  388.  
  389.      15.COME CONTATTARE L'AUTORE
  390.      Se avete qualche domanda potete contattarmi ai seguenti indirizzi:
  391.  
  392.      Posta:
  393.                      Maurizio Giunti
  394.                      Via G.B. Foggini, 24
  395.                      50142 Firenze (FI)
  396.                      ITALY
  397.  
  398.      e-mail:
  399.                      Fidonet:      2:332/102.3
  400.                      Internet:     giunti@kagi.com
  401.                                    giunti@abeline.it
  402.                                    giunti@statsun.ds.unifi.it
  403.  
  404.  
  405.  
  406.                                                                               7
  407.  
  408.  
  409.  
  410.  
  411.      16.RINGRAZIAMENTI
  412.      Vorrei  brevemente  ringraziare  gli amici  che  mi  hanno  aiutato  nello
  413.      sviluppo  di questo software e  della  documentazione  allegata, o che  si
  414.      sono coraggiosamente offerti come beta-testers. In ordine alfabetico:
  415.  
  416.  
  417.                              Mauricio Mello de Andreade
  418.  
  419.                                    Andrea Baitelli
  420.  
  421.                                     Silvia Borri
  422.  
  423.                                  Juan Jose Comellas
  424.  
  425.                                     Filippo Dini
  426.  
  427.                                  Fabrizio Fioravanti
  428.  
  429.                                  Cristiano Guidoccio
  430.  
  431.                                 Giovanni Lopes Pegna
  432.  
  433.                                   Marco Maccaferri
  434.  
  435.                                   Marco Menichelli
  436.  
  437.                                    Giuseppe Scarpi
  438.  
  439.                                    Toni Tatafiore
  440.  
  441.                                     Duncan Wilcox
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.                                                                               8
  467.